doc: several minor documentation improvements #23359

ChALkeR · 2018-10-10T00:12:41Z

This is a series of 4 loosely related documentation fixes.

doc: wrap links in <> — fixes links that were broken due to inclusion of the trailing dot (note how the doc has it incorrect now), simplifies a pair of occurances of []().
doc: fix pr-url in repl.md — Now it points to the actual pr, not to /compare/, that was invalid.
doc: use reserved domains for examples in url.md — changes non-reserved domains to reserved ones in url.md, per ref.
doc: fix url example to match behavior — fixes url: WHATWG API .origin behavior does not match the documentation #22653.

Checklist

make -j4 test (UNIX), or vcbuild test (Windows) passes
documentation is changed or added
commit message follows commit guidelines

nodejs-github-bot · 2018-10-10T00:12:42Z

@ChALkeR build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/1185/pipeline

This fixes links that were broken due to inclusion of the trailing dot. Also simplifies a pair of occurances of []().

Now it points to the actual pr, not to /compare/.

Changes non-reserved domains to reserved ones in url.md. Refs: https://www.iana.org/domains/reserved

Fixes one WHATWG URL example to match the actual behavior. Fixes: nodejs#22653

Trott · 2018-10-10T01:20:33Z

Lite CI: https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/1187/

danbev · 2018-10-15T03:58:24Z

Landed in 8d29569, 4ba1ddb, 0311fcc, and 3b1baf6.

This fixes links that were broken due to inclusion of the trailing dot. Also simplifies a pair of occurances of [](). PR-URL: #23359 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>

Now it points to the actual pr, not to /compare/. PR-URL: #23359 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>

Changes non-reserved domains to reserved ones in url.md. PR-URL: #23359 Refs: https://www.iana.org/domains/reserved Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>

Fixes one WHATWG URL example to match the actual behavior. PR-URL: #23359 Fixes: #22653 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>